home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / perl / msds-prl / perl419x.zoo / perldb.pl < prev    next >
Perl Script  |  1993-07-25  |  8KB  |  259 lines
  1. package DB;
  2.  
  3. # modified Perl debugger, to be run from Emacs in perldb-mode
  4. # Ray Lischner (uunet!mntgfx!lisch) as of 5 Nov 1990
  5. # Johan Vromans -- upgrade to 4.0 pl 10
  6.  
  7. $header = '$RCSfile: perldb.pl,v $$Revision: 4.0.1.2 $$Date: 91/11/05 17:55:58 $';
  8. #
  9. # This file is automatically included if you do perl -d.
  10. # It's probably not useful to include this yourself.
  11. #
  12. # Perl supplies the values for @line and %sub.  It effectively inserts
  13. # a do DB'DB(<linenum>); in front of every place that can
  14. # have a breakpoint.  It also inserts a do 'perldb.pl' before the first line.
  15. #
  16. # $Log:    perldb.pl,v $
  17. # Revision 4.0.1.2  91/11/05  17:55:58  lwall
  18. # patch11: perldb.pl modified to run within emacs in perldb-mode
  19. # 
  20. # Revision 4.0.1.1  91/06/07  11:17:44  lwall
  21. # patch4: added $^P variable to control calling of perldb routines
  22. # patch4: debugger sometimes listed wrong number of lines for a statement
  23. # 
  24. # Revision 4.0  91/03/20  01:25:50  lwall
  25. # 4.0 baseline.
  26. # 
  27. # Revision 3.0.1.6  91/01/11  18:08:58  lwall
  28. # patch42: @_ couldn't be accessed from debugger
  29. # 
  30. # Revision 3.0.1.5  90/11/10  01:40:26  lwall
  31. # patch38: the debugger wouldn't stop correctly or do action routines
  32. # 
  33. # Revision 3.0.1.4  90/10/15  17:40:38  lwall
  34. # patch29: added caller
  35. # patch29: the debugger now understands packages and evals
  36. # patch29: scripts now run at almost full speed under the debugger
  37. # patch29: more variables are settable from debugger
  38. # 
  39. # Revision 3.0.1.3  90/08/09  04:00:58  lwall
  40. # patch19: debugger now allows continuation lines
  41. # patch19: debugger can now dump lists of variables
  42. # patch19: debugger can now add aliases easily from prompt
  43. # 
  44. # Revision 3.0.1.2  90/03/12  16:39:39  lwall
  45. # patch13: perl -d didn't format stack traces of *foo right
  46. # patch13: perl -d wiped out scalar return values of subroutines
  47. # 
  48. # Revision 3.0.1.1  89/10/26  23:14:02  lwall
  49. # patch1: RCS expanded an unintended $Header in lib/perldb.pl
  50. # 
  51. # Revision 3.0  89/10/18  15:19:46  lwall
  52. # 3.0 baseline
  53. # 
  54. # Revision 2.0  88/06/05  00:09:45  root
  55. # Baseline version 2.0.
  56. # 
  57. #
  58.  
  59. open(IN, "<CON") || open(IN,  "<&STDIN");    # so we don't dingle stdin
  60. open(OUT,">CON") || open(OUT, ">&STDOUT");    # so we don't dongle stdout
  61. select(OUT);
  62. $| = 1;                # for DB'OUT
  63. select(STDOUT);
  64. $| = 1;                # for real STDOUT
  65. $sub = '';
  66.  
  67. # Is Perl being run from Emacs?
  68. $emacs = $main'ARGV[$[] eq '-emacs';
  69. shift(@main'ARGV) if $emacs;
  70.  
  71. $header =~ s/.Header: ([^,]+),v(\s+\S+\s+\S+).*$/$1$2/;
  72. print OUT "\nLoading DB routines from $header\n";
  73. print OUT ("Emacs support ",
  74.        $emacs ? "enabled" : "available",
  75.        ".\n");
  76. print OUT "\nEnter h for help.\n\n";
  77.  
  78. sub DB {
  79.     &save;
  80.     ($package, $filename, $line) = caller;
  81.     $usercontext = '($@, $!, $[, $,, $/, $\) = @saved;' .
  82.     "package $package;";        # this won't let them modify, alas
  83.     local($^P) = 0;            # don't debug our own evals
  84.     local(*dbline) = "_<$filename";
  85.     $max = $#dbline;
  86.     if (($stop,$action) = split(/\0/,$dbline{$line})) {
  87.     if ($stop eq '1') {
  88.         $signal |= 1;
  89.     }
  90.     else {
  91.         $evalarg = "\$DB'signal |= do {$stop;}"; &eval;
  92.         $dbline{$line} =~ s/;9($|\0)/$1/;
  93.     }
  94.     }
  95.     if ($single || $trace || $signal) {
  96.     if ($emacs) {
  97.         print OUT "\032\032$filename:$line:0\n";
  98.     } else {
  99.         print OUT "$package'" unless $sub =~ /'/;
  100.         print OUT "$sub($filename:$line):\t",$dbline[$line];
  101.         for ($i = $line + 1; $i <= $max && $dbline[$i] == 0; ++$i) {
  102.         last if $dbline[$i] =~ /^\s*(}|#|\n)/;
  103.         print OUT "$sub($filename:$i):\t",$dbline[$i];
  104.         }
  105.     }
  106.     }
  107.     $evalarg = $action, &eval if $action;
  108.     if ($single || $signal) {
  109.     $evalarg = $pre, &eval if $pre;
  110.     print OUT $#stack . " levels deep in subroutine calls!\n"
  111.         if $single & 4;
  112.     $start = $line;
  113.       CMD:
  114.     while ((print OUT "  DB<", $#hist+1, "> "), $cmd=&gets) {
  115.         {
  116.         $single = 0;
  117.         $signal = 0;
  118.         $cmd eq '' && exit 0;
  119.         chop($cmd);
  120.         $cmd =~ s/\\$// && do {
  121.             print OUT "  cont: ";
  122.             $cmd .= &gets;
  123.             redo CMD;
  124.         };
  125.         $cmd =~ /^q$/ && exit 0;
  126.         $cmd =~ /^$/ && ($cmd = $laststep);
  127.         push(@hist,$cmd) if length($cmd) > 1;
  128.         ($i) = split(/\s+/,$cmd);
  129.         eval "\$cmd =~ $alias{$i}", print OUT $@ if $alias{$i};
  130.         $cmd =~ /^h$/ && do {
  131.             print OUT "
  132. T        Stack trace.
  133. s        Single step.
  134. n        Next, steps over subroutine calls.
  135. r        Return from current subroutine.
  136. c [line]    Continue; optionally inserts a one-time-only breakpoint 
  137.         at the specified line.
  138. <CR>        Repeat last n or s.
  139. l min+incr    List incr+1 lines starting at min.
  140. l min-max    List lines.
  141. l line        List line;
  142. l        List next window.
  143. -        List previous window.
  144. w line        List window around line.
  145. l subname    List subroutine.
  146. f filename    Switch to filename.
  147. /pattern/    Search forwards for pattern; final / is optional.
  148. ?pattern?    Search backwards for pattern.
  149. L        List breakpoints and actions.
  150. S        List subroutine names.
  151. t        Toggle trace mode.
  152. b [line] [condition]
  153.         Set breakpoint; line defaults to the current execution line; 
  154.         condition breaks if it evaluates to true, defaults to \'1\'.
  155. b subname [condition]
  156.         Set breakpoint at first line of subroutine.
  157. d [line]    Delete breakpoint.
  158. D        Delete all breakpoints.
  159. a [line] command
  160.         Set an action to be done before the line is executed.
  161.         Sequence is: check for breakpoint, print line if necessary,
  162.         do action, prompt user if breakpoint or step, evaluate line.
  163. A        Delete all actions.
  164. V [pkg [vars]]    List some (default all) variables in package (default current).
  165. X [vars]    Same as \"V currentpackage [vars]\".
  166. < command    Define command before prompt.
  167. > command    Define command after prompt.
  168. ! number    Redo command (default previous command).
  169. ! -number    Redo number\'th to last command.
  170. H -number    Display last number commands (default all).
  171. q or ^D        Quit.
  172. p expr        Same as \"print DB'OUT expr\" in current package.
  173. = [alias value]    Define a command alias, or list current aliases.
  174. command        Execute as a perl statement in current package.
  175.  
  176. ";
  177.             next CMD; };
  178.         $cmd =~ /^t$/ && do {
  179.             $trace = !$trace;
  180.             print OUT "Trace = ".($trace?"on":"off")."\n";
  181.             next CMD; };
  182.         $cmd =~ /^S$/ && do {
  183.             foreach $subname (sort(keys %sub)) {
  184.             print OUT $subname,"\n";
  185.             }
  186.             next CMD; };
  187.         $cmd =~ s/^X\b/V $package/;
  188.         $cmd =~ /^V$/ && do {
  189.             $cmd = 'V $package'; };
  190.         $cmd =~ /^V\b\s*(\S+)\s*(.*)/ && do {
  191.             $packname = $1;
  192.             @vars = split(' ',$2);
  193.             do 'dumpvar.pl' unless defined &main'dumpvar;
  194.             if (defined &main'dumpvar) {
  195.             &main'dumpvar($packname,@vars);
  196.             }
  197.             else {
  198.             print DB'OUT "dumpvar.pl not available.\n";
  199.             }
  200.             next CMD; };
  201.         $cmd =~ /^f\b\s*(.*)/ && do {
  202.             $file = $1;
  203.             if (!$file) {
  204.             print OUT "The old f command is now the r command.\n";
  205.             print OUT "The new f command switches filenames.\n";
  206.             next CMD;
  207.             }
  208.             if (!defined $_main{'_<' . $file}) {
  209.             if (($try) = grep(m#^_<.*$file#, keys %_main)) {
  210.                 $file = substr($try,2);
  211.                 print "\n$file:\n";
  212.             }
  213.             }
  214.             if (!defined $_main{'_<' . $file}) {
  215.             print OUT "There's no code here anything matching $file.\n";
  216.             next CMD;
  217.             }
  218.             elsif ($file ne $filename) {
  219.             *dbline = "_<$file";
  220.             $max = $#dbline;
  221.             $filename = $file;
  222.             $start = 1;
  223.             $cmd = "l";
  224.             } };
  225.         $cmd =~ /^l\b\s*(['A-Za-z_]['\w]*)/ && do {
  226.             $subname = $1;
  227.             $subname = "main'" . $subname unless $subname =~ /'/;
  228.             $subname = "main" . $subname if substr($subname,0,1) eq "'";
  229.             ($file,$subrange) = split(/:/,$sub{$subname});
  230.             if ($file ne $filename) {
  231.             *dbline = "_<$file";
  232.             $max = $#dbline;
  233.             $filename = $file;
  234.             }
  235.             if ($subrange) {
  236.             if (eval($subrange) < -$window) {
  237.                 $subrange =~ s/-.*/+/;
  238.             }
  239.             $cmd = "l $subrange";
  240.             } else {
  241.             print OUT "Subroutine $1 not found.\n";
  242.             next CMD;
  243.             } };
  244.         $cmd =~ /^w\b\s*(\d*)$/ && do {
  245.             $incr = $window - 1;
  246.             $start = $1 if $1;
  247.             $start -= $preview;
  248.             $cmd = 'l ' . $start . '-' . ($start + $incr); };
  249.         $cmd =~ /^-$/ && do {
  250.             $incr = $window - 1;
  251.             $cmd = 'l ' . ($start-$window*2) . '+'; };
  252.         $cmd =~ /^l$/ && do {
  253.             $incr = $window - 1;
  254.             $cmd = 'l ' . $start . '-' . ($start + $incr); };
  255.         $cmd =~ /^l\b\s*(\d*)\+(\d*)$/ && do {
  256.             $start = $1 if $1;
  257.             $incr = $2;
  258.             $incr = $window - 1 unless $incr;
  259.